package com.zhuo.common.service.tencent;

import com.qcloud.cos.COSClient;
import com.qcloud.cos.ClientConfig;
import com.qcloud.cos.auth.BasicCOSCredentials;
import com.qcloud.cos.auth.COSCredentials;
import com.qcloud.cos.http.HttpProtocol;
import com.qcloud.cos.region.Region;

/**
 * @author 卓东东
 * @description: cos工具类
 * @since 2025/9/30
 */
public class CosUtil {

    /**
     * 生成 cos 客户端（指定地域）
     *
     * @param secretId\secretKey 密钥对
     * @param region             地域
     * @return cos 客户端
     */
    public static COSClient createCOSClient(String secretId, String secretKey, String region) {
        // 1 初始化用户身份信息（secretId, secretKey）。
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        // 2 设置 bucket 的地域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224
        // clientConfig 中包含了设置 region, https(默认 http), 超时, 代理等 set 方法, 使用可参见源码或者常见问题 Java SDK 部分。
        Region regions = new Region(region);
        ClientConfig clientConfig = new ClientConfig(regions);
        // 从 5.6.54 版本开始，默认使用了 https
        clientConfig.setHttpProtocol(HttpProtocol.https);
        // 3 生成 cos 客户端。
        return new COSClient(cred, clientConfig);
    }
}
